
\begin{apiRoute}{POST}{/tags}{Create new tag}
{
}
{ }

\begin{routeResponse}{application/json}
\responseItem{201}{Created}{ID in response body}
\end{routeResponse}
\end{apiRoute}




\begin{apiRoute}{GET}{/tags?offset=\param{offset}\&length=\param{length}}{Get all tags}
{
}
{ }
\begin{queryParameter} 
\queryParamItem{offset}{integer}
\queryParamItem{length}{integer}
\end{queryParameter}

\begin{routeResponse}{application/json}
\responseItem{200}{ok}{}
\end{routeResponse}
\end{apiRoute}




\begin{apiRoute}{GET}{/tags/\param{id}}{View details tag with given ID}
{
}
{ }

\begin{routeParameter} 
\routeParamItem{id}{string}
\end{routeParameter}
\begin{routeResponse}{application/json}
\responseItem{200}{ok}{}
\responseItem{400}{Bad Request}{ID not well formed}
\responseItem{404}{Not found}{Tag with ID does not exists.}
\end{routeResponse}
\end{apiRoute}



\begin{apiRoute}{DELETE}{/tags/\param{id}}{Path description}
{
}
{ }

\begin{routeParameter} 
\routeParamItem{id}{string}
\end{routeParameter}
\begin{routeResponse}{application/json}
\responseItem{204}{No content}{}
\responseItem{400}{Bad Request}{ID not well formed}
\responseItem{404}{Not found}{Tag with ID does not exists.}

\end{routeResponse}
\end{apiRoute}

